home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1348.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  2.8 KB  |  117 lines
  1. 86
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. InstallFont 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baInstallFont installs a TrueType or Bitmap font.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baInstallFont( FontFile , FontName )
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. FontFile is the .ttf or .fon file to install. 
  36. --- RECORDSEPARATOR ---
  37. FontName is the name of the font.
  38. --- RECORDSEPARATOR ---
  39.  
  40. --- RECORDSEPARATOR ---
  41. Returns:
  42. --- RECORDSEPARATOR ---
  43.  
  44. --- RECORDSEPARATOR ---
  45. Integer. 
  46. --- RECORDSEPARATOR ---
  47. Returns 0 if font installs OK. Otherwise returns one of: 
  48. --- RECORDSEPARATOR ---
  49. 1 
  50. --- RECORDSEPARATOR ---
  51. A font file with that name already exists. 
  52. --- RECORDSEPARATOR ---
  53. 2 
  54. --- RECORDSEPARATOR ---
  55. The font file was not found. 
  56. --- RECORDSEPARATOR ---
  57. 3 
  58. --- RECORDSEPARATOR ---
  59. Error copying font file. 
  60. --- RECORDSEPARATOR ---
  61. 4 
  62. --- RECORDSEPARATOR ---
  63. Windows couldn't install the font. 
  64. --- RECORDSEPARATOR ---
  65. 5 
  66. --- RECORDSEPARATOR ---
  67. The font file is an invalid name.
  68. --- RECORDSEPARATOR ---
  69.  
  70. --- RECORDSEPARATOR ---
  71. Examples:
  72. --- RECORDSEPARATOR ---
  73.  
  74. --- RECORDSEPARATOR ---
  75. Director: 
  76. --- RECORDSEPARATOR ---
  77. set OK = baInstallFont( the moviePath & "arialb.ttf" , "Arial Bold"  ) 
  78. --- RECORDSEPARATOR ---
  79. Authorware: 
  80. --- RECORDSEPARATOR ---
  81. OK := baInstallFont( FileLocation ^ "arialb.ttf" , "Arial Bold"  )
  82. --- RECORDSEPARATOR ---
  83.  
  84. --- RECORDSEPARATOR ---
  85. Notes:
  86. --- RECORDSEPARATOR ---
  87.  
  88. --- RECORDSEPARATOR ---
  89. Most fonts are copyrighted material. You should not install a font unless you are 
  90. --- RECORDSEPARATOR ---
  91. legally allowed to do so. 
  92. --- RECORDSEPARATOR ---
  93. The name of the font should be taken from the Fonts Control Panel. The name that 
  94. --- RECORDSEPARATOR ---
  95. Windows identifies the font to applications is taken from information inside the font 
  96. --- RECORDSEPARATOR ---
  97. file, not the name you give it. 
  98. --- RECORDSEPARATOR ---
  99. You should use the FontInstalled command to check whether or not a particular 
  100. --- RECORDSEPARATOR ---
  101. font is already installed before you try to install a new copy. 
  102. --- RECORDSEPARATOR ---
  103. Director does not rebuild it's font list after it has been started. This means that the 
  104. --- RECORDSEPARATOR ---
  105. font will not be available to the projector that installed it unless it is restarted. All 
  106. --- RECORDSEPARATOR ---
  107. versions of Authorware should be able to use the font immediately. There is usually 
  108. --- RECORDSEPARATOR ---
  109. no need to restart Windows.
  110. --- RECORDSEPARATOR ---
  111.  
  112. --- RECORDSEPARATOR ---
  113. See also:
  114. --- RECORDSEPARATOR ---
  115.  
  116. --- RECORDSEPARATOR ---
  117. baFontInstalled